<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>get_surface_matching_result [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_3dmatching.html">3D 匹配</a> / <a href="toc_3dmatching_surfacebased.html">Surface-Based</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">get_surface_matching_result</span><span data-if="c" style="display:none;">T_get_surface_matching_result</span><span data-if="cpp" style="display:none;">GetSurfaceMatchingResult</span><span data-if="dotnet" style="display:none;">GetSurfaceMatchingResult</span><span data-if="python" style="display:none;">get_surface_matching_result</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">get_surface_matching_result</span><span data-if="c" style="display:none;">T_get_surface_matching_result</span><span data-if="cpp" style="display:none;">GetSurfaceMatchingResult</span><span data-if="dotnet" style="display:none;">GetSurfaceMatchingResult</span><span data-if="python" style="display:none;">get_surface_matching_result</span></code> — Get details of a result from surface based matching.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>get_surface_matching_result</b>( :  : <a href="#SurfaceMatchingResultID"><i>SurfaceMatchingResultID</i></a>, <a href="#ResultName"><i>ResultName</i></a>, <a href="#ResultIndex"><i>ResultIndex</i></a> : <a href="#ResultValue"><i>ResultValue</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_get_surface_matching_result</b>(const Htuple <a href="#SurfaceMatchingResultID"><i>SurfaceMatchingResultID</i></a>, const Htuple <a href="#ResultName"><i>ResultName</i></a>, const Htuple <a href="#ResultIndex"><i>ResultIndex</i></a>, Htuple* <a href="#ResultValue"><i>ResultValue</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>GetSurfaceMatchingResult</b>(const HTuple&amp; <a href="#SurfaceMatchingResultID"><i>SurfaceMatchingResultID</i></a>, const HTuple&amp; <a href="#ResultName"><i>ResultName</i></a>, const HTuple&amp; <a href="#ResultIndex"><i>ResultIndex</i></a>, HTuple* <a href="#ResultValue"><i>ResultValue</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HSurfaceMatchingResult.html">HSurfaceMatchingResult</a>::<b>GetSurfaceMatchingResult</b>(const HTuple&amp; <a href="#ResultName"><i>ResultName</i></a>, Hlong <a href="#ResultIndex"><i>ResultIndex</i></a>) const</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HSurfaceMatchingResult.html">HSurfaceMatchingResult</a>::<b>GetSurfaceMatchingResult</b>(const HString&amp; <a href="#ResultName"><i>ResultName</i></a>, Hlong <a href="#ResultIndex"><i>ResultIndex</i></a>) const</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HSurfaceMatchingResult.html">HSurfaceMatchingResult</a>::<b>GetSurfaceMatchingResult</b>(const char* <a href="#ResultName"><i>ResultName</i></a>, Hlong <a href="#ResultIndex"><i>ResultIndex</i></a>) const</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HSurfaceMatchingResult.html">HSurfaceMatchingResult</a>::<b>GetSurfaceMatchingResult</b>(const wchar_t* <a href="#ResultName"><i>ResultName</i></a>, Hlong <a href="#ResultIndex"><i>ResultIndex</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>GetSurfaceMatchingResult</b>(<a href="HTuple.html">HTuple</a> <a href="#SurfaceMatchingResultID"><i>surfaceMatchingResultID</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ResultName"><i>resultName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ResultIndex"><i>resultIndex</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#ResultValue"><i>resultValue</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HSurfaceMatchingResult.html">HSurfaceMatchingResult</a>.<b>GetSurfaceMatchingResult</b>(<a href="HTuple.html">HTuple</a> <a href="#ResultName"><i>resultName</i></a>, int <a href="#ResultIndex"><i>resultIndex</i></a>)</code></p>
<p>
<code><a href="HTuple.html">HTuple</a> <a href="HSurfaceMatchingResult.html">HSurfaceMatchingResult</a>.<b>GetSurfaceMatchingResult</b>(string <a href="#ResultName"><i>resultName</i></a>, int <a href="#ResultIndex"><i>resultIndex</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>get_surface_matching_result</b>(<a href="#SurfaceMatchingResultID"><i>surface_matching_result_id</i></a>: HHandle, <a href="#ResultName"><i>result_name</i></a>: MaybeSequence[str], <a href="#ResultIndex"><i>result_index</i></a>: int) -&gt; Sequence[HTupleElementType]</code></p>
<p>
<code>def <b>get_surface_matching_result_s</b>(<a href="#SurfaceMatchingResultID"><i>surface_matching_result_id</i></a>: HHandle, <a href="#ResultName"><i>result_name</i></a>: MaybeSequence[str], <a href="#ResultIndex"><i>result_index</i></a>: int) -&gt; HTupleElementType</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">get_surface_matching_result</span><span data-if="c" style="display:none">get_surface_matching_result</span><span data-if="cpp" style="display:none">GetSurfaceMatchingResult</span><span data-if="com" style="display:none">GetSurfaceMatchingResult</span><span data-if="dotnet" style="display:none">GetSurfaceMatchingResult</span><span data-if="python" style="display:none">get_surface_matching_result</span></code> returns details about
the results of surface based matching or the surface pose refinement.
The results are
stored in <a href="#SurfaceMatchingResultID"><i><code><span data-if="hdevelop" style="display:inline">SurfaceMatchingResultID</span><span data-if="c" style="display:none">SurfaceMatchingResultID</span><span data-if="cpp" style="display:none">SurfaceMatchingResultID</span><span data-if="com" style="display:none">SurfaceMatchingResultID</span><span data-if="dotnet" style="display:none">surfaceMatchingResultID</span><span data-if="python" style="display:none">surface_matching_result_id</span></code></i></a>, which must have been created
by <a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a> or <a href="refine_surface_model_pose.html"><code><span data-if="hdevelop" style="display:inline">refine_surface_model_pose</span><span data-if="c" style="display:none">refine_surface_model_pose</span><span data-if="cpp" style="display:none">RefineSurfaceModelPose</span><span data-if="com" style="display:none">RefineSurfaceModelPose</span><span data-if="dotnet" style="display:none">RefineSurfaceModelPose</span><span data-if="python" style="display:none">refine_surface_model_pose</span></code></a>.
</p>
<p>The parameter <a href="#ResultName"><i><code><span data-if="hdevelop" style="display:inline">ResultName</span><span data-if="c" style="display:none">ResultName</span><span data-if="cpp" style="display:none">ResultName</span><span data-if="com" style="display:none">ResultName</span><span data-if="dotnet" style="display:none">resultName</span><span data-if="python" style="display:none">result_name</span></code></i></a> is used to select which result detail
shall be returned. If details about one of the results shall be retrieved,
<a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> selects the result index, where <i>0</i> selects
the first result.
<a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> is ignored for certain values of <a href="#ResultName"><i><code><span data-if="hdevelop" style="display:inline">ResultName</span><span data-if="c" style="display:none">ResultName</span><span data-if="cpp" style="display:none">ResultName</span><span data-if="com" style="display:none">ResultName</span><span data-if="dotnet" style="display:none">resultName</span><span data-if="python" style="display:none">result_name</span></code></i></a>.
</p>
<p>The following values are possible for <a href="#ResultName"><i><code><span data-if="hdevelop" style="display:inline">ResultName</span><span data-if="c" style="display:none">ResultName</span><span data-if="cpp" style="display:none">ResultName</span><span data-if="com" style="display:none">ResultName</span><span data-if="dotnet" style="display:none">resultName</span><span data-if="python" style="display:none">result_name</span></code></i></a> if
<a href="#SurfaceMatchingResultID"><i><code><span data-if="hdevelop" style="display:inline">SurfaceMatchingResultID</span><span data-if="c" style="display:none">SurfaceMatchingResultID</span><span data-if="cpp" style="display:none">SurfaceMatchingResultID</span><span data-if="com" style="display:none">SurfaceMatchingResultID</span><span data-if="dotnet" style="display:none">surfaceMatchingResultID</span><span data-if="python" style="display:none">surface_matching_result_id</span></code></i></a> was created by <a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a>
or <a href="find_surface_model_image.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model_image</span><span data-if="c" style="display:none">find_surface_model_image</span><span data-if="cpp" style="display:none">FindSurfaceModelImage</span><span data-if="com" style="display:none">FindSurfaceModelImage</span><span data-if="dotnet" style="display:none">FindSurfaceModelImage</span><span data-if="python" style="display:none">find_surface_model_image</span></code></a>:
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'sampled_scene'</span><span data-if="c" style="display:none">"sampled_scene"</span><span data-if="cpp" style="display:none">"sampled_scene"</span><span data-if="com" style="display:none">"sampled_scene"</span><span data-if="dotnet" style="display:none">"sampled_scene"</span><span data-if="python" style="display:none">"sampled_scene"</span></i>:</b></dt>
<dd><p>

A 3D object model handle is returned that
contains the sampled scene points that were used in the
approximate matching step.
This is helpful for tuning the sampling distance for the
matching (see parameter RelSamplingDistance of operator
<a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a>).
The parameter <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> is ignored.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'key_points'</span><span data-if="c" style="display:none">"key_points"</span><span data-if="cpp" style="display:none">"key_points"</span><span data-if="com" style="display:none">"key_points"</span><span data-if="dotnet" style="display:none">"key_points"</span><span data-if="python" style="display:none">"key_points"</span></i>:</b></dt>
<dd><p>

A 3D object model handle is returned that
contains all points from the 3D scene that were used as key
points in the matching process.
This is helpful for tuning the sampling
distance and key point rate for the matching (see parameter
KeyPointFraction of operator <a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a>).
The parameter <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> is ignored.
At least 10 key points should be on the object of interest for
stable results.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'score_unrefined'</span><span data-if="c" style="display:none">"score_unrefined"</span><span data-if="cpp" style="display:none">"score_unrefined"</span><span data-if="com" style="display:none">"score_unrefined"</span><span data-if="dotnet" style="display:none">"score_unrefined"</span><span data-if="python" style="display:none">"score_unrefined"</span></i>:</b></dt>
<dd><p>

The score of the result before the
dense pose refinement is returned. If the sparse pose refinement was
disabled, this is the score of the approximate matching. Otherwise the
score of the sparse pose refinement is returned.
See <a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a> for details about the score.
In <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> the index of the result must be specified.
If <a href="#SurfaceMatchingResultID"><i><code><span data-if="hdevelop" style="display:inline">SurfaceMatchingResultID</span><span data-if="c" style="display:none">SurfaceMatchingResultID</span><span data-if="cpp" style="display:none">SurfaceMatchingResultID</span><span data-if="com" style="display:none">SurfaceMatchingResultID</span><span data-if="dotnet" style="display:none">surfaceMatchingResultID</span><span data-if="python" style="display:none">surface_matching_result_id</span></code></i></a> was created by
<a href="refine_surface_model_pose.html"><code><span data-if="hdevelop" style="display:inline">refine_surface_model_pose</span><span data-if="c" style="display:none">refine_surface_model_pose</span><span data-if="cpp" style="display:none">RefineSurfaceModelPose</span><span data-if="com" style="display:none">RefineSurfaceModelPose</span><span data-if="dotnet" style="display:none">RefineSurfaceModelPose</span><span data-if="python" style="display:none">refine_surface_model_pose</span></code></a>, 0 is returned.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'sampled_3d_edges'</span><span data-if="c" style="display:none">"sampled_3d_edges"</span><span data-if="cpp" style="display:none">"sampled_3d_edges"</span><span data-if="com" style="display:none">"sampled_3d_edges"</span><span data-if="dotnet" style="display:none">"sampled_3d_edges"</span><span data-if="python" style="display:none">"sampled_3d_edges"</span></i>:</b></dt>
<dd><p>

If the surface model was trained with <i><span data-if="hdevelop" style="display:inline">'train_3d_edges'</span><span data-if="c" style="display:none">"train_3d_edges"</span><span data-if="cpp" style="display:none">"train_3d_edges"</span><span data-if="com" style="display:none">"train_3d_edges"</span><span data-if="dotnet" style="display:none">"train_3d_edges"</span><span data-if="python" style="display:none">"train_3d_edges"</span></i>
enabled, a 3D object model handle is returned that
contains the sampled 3D edge points that were used in the
approximate matching step and in the sparse refinement step.
The parameter <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> is ignored.
</p></dd>
</dl>
<p>The following values are always possible for <a href="#ResultName"><i><code><span data-if="hdevelop" style="display:inline">ResultName</span><span data-if="c" style="display:none">ResultName</span><span data-if="cpp" style="display:none">ResultName</span><span data-if="com" style="display:none">ResultName</span><span data-if="dotnet" style="display:none">resultName</span><span data-if="python" style="display:none">result_name</span></code></i></a>,
regardless 该算子 <a href="#SurfaceMatchingResultID"><i><code><span data-if="hdevelop" style="display:inline">SurfaceMatchingResultID</span><span data-if="c" style="display:none">SurfaceMatchingResultID</span><span data-if="cpp" style="display:none">SurfaceMatchingResultID</span><span data-if="com" style="display:none">SurfaceMatchingResultID</span><span data-if="dotnet" style="display:none">surfaceMatchingResultID</span><span data-if="python" style="display:none">surface_matching_result_id</span></code></i></a> was created with:
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'pose'</span><span data-if="c" style="display:none">"pose"</span><span data-if="cpp" style="display:none">"pose"</span><span data-if="com" style="display:none">"pose"</span><span data-if="dotnet" style="display:none">"pose"</span><span data-if="python" style="display:none">"pose"</span></i>:</b></dt>
<dd>
<p>

Returns the pose of the matching or refinement result.
In <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> the index of the result must be specified.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'score_refined'</span><span data-if="c" style="display:none">"score_refined"</span><span data-if="cpp" style="display:none">"score_refined"</span><span data-if="com" style="display:none">"score_refined"</span><span data-if="dotnet" style="display:none">"score_refined"</span><span data-if="python" style="display:none">"score_refined"</span></i>:</b></dt>
<dd>
<p>

Returns the score of the result after the dense pose refinement.
See <a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a> for details about this score.
In <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a> the index of the result must be specified.
If <a href="#SurfaceMatchingResultID"><i><code><span data-if="hdevelop" style="display:inline">SurfaceMatchingResultID</span><span data-if="c" style="display:none">SurfaceMatchingResultID</span><span data-if="cpp" style="display:none">SurfaceMatchingResultID</span><span data-if="com" style="display:none">SurfaceMatchingResultID</span><span data-if="dotnet" style="display:none">surfaceMatchingResultID</span><span data-if="python" style="display:none">surface_matching_result_id</span></code></i></a> was created by
<a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a> and dense pose refinement was disabled,
<i>0</i> is returned.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'score'</span><span data-if="c" style="display:none">"score"</span><span data-if="cpp" style="display:none">"score"</span><span data-if="com" style="display:none">"score"</span><span data-if="dotnet" style="display:none">"score"</span><span data-if="python" style="display:none">"score"</span></i>:</b></dt>
<dd>
<p>

Returns the combined score of the result indexed in <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a>,
thus this parameter is equal to <code><span data-if="hdevelop" style="display:inline">Score</span><span data-if="c" style="display:none">Score</span><span data-if="cpp" style="display:none">Score</span><span data-if="com" style="display:none">Score</span><span data-if="dotnet" style="display:none">score</span><span data-if="python" style="display:none">score</span></code> returned in
<a href="find_surface_model.html"><code><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></code></a>.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'score_surface'</span><span data-if="c" style="display:none">"score_surface"</span><span data-if="cpp" style="display:none">"score_surface"</span><span data-if="com" style="display:none">"score_surface"</span><span data-if="dotnet" style="display:none">"score_surface"</span><span data-if="python" style="display:none">"score_surface"</span></i>:</b></dt>
<dd>
<p>

Returns the surface-based score of the result indexed in
<a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a>.
If not specifically set otherwise, this score is equal to
<i><span data-if="hdevelop" style="display:inline">'score_refined'</span><span data-if="c" style="display:none">"score_refined"</span><span data-if="cpp" style="display:none">"score_refined"</span><span data-if="com" style="display:none">"score_refined"</span><span data-if="dotnet" style="display:none">"score_refined"</span><span data-if="python" style="display:none">"score_refined"</span></i>.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'score_3d_edges'</span><span data-if="c" style="display:none">"score_3d_edges"</span><span data-if="cpp" style="display:none">"score_3d_edges"</span><span data-if="com" style="display:none">"score_3d_edges"</span><span data-if="dotnet" style="display:none">"score_3d_edges"</span><span data-if="python" style="display:none">"score_3d_edges"</span></i>:</b></dt>
<dd>
<p>

Returns the 3D edge score of the result indexed in
<a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a>.
This score is only applicable for edged-supported surface-based matching.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'score_2d_edges'</span><span data-if="c" style="display:none">"score_2d_edges"</span><span data-if="cpp" style="display:none">"score_2d_edges"</span><span data-if="com" style="display:none">"score_2d_edges"</span><span data-if="dotnet" style="display:none">"score_2d_edges"</span><span data-if="python" style="display:none">"score_2d_edges"</span></i>:</b></dt>
<dd>
<p>

Returns the 2D edge score of the result indexed in
<a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a>.
This score is only applicable for edged-supported surface-based matching.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'score_view_based'</span><span data-if="c" style="display:none">"score_view_based"</span><span data-if="cpp" style="display:none">"score_view_based"</span><span data-if="com" style="display:none">"score_view_based"</span><span data-if="dotnet" style="display:none">"score_view_based"</span><span data-if="python" style="display:none">"score_view_based"</span></i>:</b></dt>
<dd>
<p>

Returns the view-based score of the result indexed in
<a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a>.
This score is only applicable if the surface model supports view-based
score computation.
</p>
</dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'all_scores'</span><span data-if="c" style="display:none">"all_scores"</span><span data-if="cpp" style="display:none">"all_scores"</span><span data-if="com" style="display:none">"all_scores"</span><span data-if="dotnet" style="display:none">"all_scores"</span><span data-if="python" style="display:none">"all_scores"</span></i>:</b></dt>
<dd>
<p>

Returns for the result indexed in <a href="#ResultIndex"><i><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></i></a>
the values of the five scores
<i><span data-if="hdevelop" style="display:inline">'score'</span><span data-if="c" style="display:none">"score"</span><span data-if="cpp" style="display:none">"score"</span><span data-if="com" style="display:none">"score"</span><span data-if="dotnet" style="display:none">"score"</span><span data-if="python" style="display:none">"score"</span></i>, <i><span data-if="hdevelop" style="display:inline">'score_surface'</span><span data-if="c" style="display:none">"score_surface"</span><span data-if="cpp" style="display:none">"score_surface"</span><span data-if="com" style="display:none">"score_surface"</span><span data-if="dotnet" style="display:none">"score_surface"</span><span data-if="python" style="display:none">"score_surface"</span></i>, <i><span data-if="hdevelop" style="display:inline">'score_3d_edges'</span><span data-if="c" style="display:none">"score_3d_edges"</span><span data-if="cpp" style="display:none">"score_3d_edges"</span><span data-if="com" style="display:none">"score_3d_edges"</span><span data-if="dotnet" style="display:none">"score_3d_edges"</span><span data-if="python" style="display:none">"score_3d_edges"</span></i>,
<i><span data-if="hdevelop" style="display:inline">'score_2d_edges'</span><span data-if="c" style="display:none">"score_2d_edges"</span><span data-if="cpp" style="display:none">"score_2d_edges"</span><span data-if="com" style="display:none">"score_2d_edges"</span><span data-if="dotnet" style="display:none">"score_2d_edges"</span><span data-if="python" style="display:none">"score_2d_edges"</span></i>, and <i><span data-if="hdevelop" style="display:inline">'score_view_based'</span><span data-if="c" style="display:none">"score_view_based"</span><span data-if="cpp" style="display:none">"score_view_based"</span><span data-if="com" style="display:none">"score_view_based"</span><span data-if="dotnet" style="display:none">"score_view_based"</span><span data-if="python" style="display:none">"score_view_based"</span></i>.
Thereby the scores have the same order as the thresholds given through the
parameter <code><span data-if="hdevelop" style="display:inline">MinScore</span><span data-if="c" style="display:none">MinScore</span><span data-if="cpp" style="display:none">MinScore</span><span data-if="com" style="display:none">MinScore</span><span data-if="dotnet" style="display:none">minScore</span><span data-if="python" style="display:none">min_score</span></code> in the matching and refinement operators.
</p>
</dd>
</dl>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="SurfaceMatchingResultID" class="parname"><b><code><span data-if="hdevelop" style="display:inline">SurfaceMatchingResultID</span><span data-if="c" style="display:none">SurfaceMatchingResultID</span><span data-if="cpp" style="display:none">SurfaceMatchingResultID</span><span data-if="com" style="display:none">SurfaceMatchingResultID</span><span data-if="dotnet" style="display:none">surfaceMatchingResultID</span><span data-if="python" style="display:none">surface_matching_result_id</span></code></b> (input_control)  </span><span>surface_matching_result <code>→</code> <span data-if="dotnet" style="display:none"><a href="HSurfaceMatchingResult.html">HSurfaceMatchingResult</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the surface matching result.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ResultName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ResultName</span><span data-if="c" style="display:none">ResultName</span><span data-if="cpp" style="display:none">ResultName</span><span data-if="com" style="display:none">ResultName</span><span data-if="dotnet" style="display:none">resultName</span><span data-if="python" style="display:none">result_name</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Name of the result property.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'pose'</span>
    <span data-if="c" style="display:none">"pose"</span>
    <span data-if="cpp" style="display:none">"pose"</span>
    <span data-if="com" style="display:none">"pose"</span>
    <span data-if="dotnet" style="display:none">"pose"</span>
    <span data-if="python" style="display:none">"pose"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'all_scores'</span><span data-if="c" style="display:none">"all_scores"</span><span data-if="cpp" style="display:none">"all_scores"</span><span data-if="com" style="display:none">"all_scores"</span><span data-if="dotnet" style="display:none">"all_scores"</span><span data-if="python" style="display:none">"all_scores"</span>, <span data-if="hdevelop" style="display:inline">'key_points'</span><span data-if="c" style="display:none">"key_points"</span><span data-if="cpp" style="display:none">"key_points"</span><span data-if="com" style="display:none">"key_points"</span><span data-if="dotnet" style="display:none">"key_points"</span><span data-if="python" style="display:none">"key_points"</span>, <span data-if="hdevelop" style="display:inline">'pose'</span><span data-if="c" style="display:none">"pose"</span><span data-if="cpp" style="display:none">"pose"</span><span data-if="com" style="display:none">"pose"</span><span data-if="dotnet" style="display:none">"pose"</span><span data-if="python" style="display:none">"pose"</span>, <span data-if="hdevelop" style="display:inline">'sampled_3d_edges'</span><span data-if="c" style="display:none">"sampled_3d_edges"</span><span data-if="cpp" style="display:none">"sampled_3d_edges"</span><span data-if="com" style="display:none">"sampled_3d_edges"</span><span data-if="dotnet" style="display:none">"sampled_3d_edges"</span><span data-if="python" style="display:none">"sampled_3d_edges"</span>, <span data-if="hdevelop" style="display:inline">'sampled_scene'</span><span data-if="c" style="display:none">"sampled_scene"</span><span data-if="cpp" style="display:none">"sampled_scene"</span><span data-if="com" style="display:none">"sampled_scene"</span><span data-if="dotnet" style="display:none">"sampled_scene"</span><span data-if="python" style="display:none">"sampled_scene"</span>, <span data-if="hdevelop" style="display:inline">'score'</span><span data-if="c" style="display:none">"score"</span><span data-if="cpp" style="display:none">"score"</span><span data-if="com" style="display:none">"score"</span><span data-if="dotnet" style="display:none">"score"</span><span data-if="python" style="display:none">"score"</span>, <span data-if="hdevelop" style="display:inline">'score_2d_edges'</span><span data-if="c" style="display:none">"score_2d_edges"</span><span data-if="cpp" style="display:none">"score_2d_edges"</span><span data-if="com" style="display:none">"score_2d_edges"</span><span data-if="dotnet" style="display:none">"score_2d_edges"</span><span data-if="python" style="display:none">"score_2d_edges"</span>, <span data-if="hdevelop" style="display:inline">'score_3d_edges'</span><span data-if="c" style="display:none">"score_3d_edges"</span><span data-if="cpp" style="display:none">"score_3d_edges"</span><span data-if="com" style="display:none">"score_3d_edges"</span><span data-if="dotnet" style="display:none">"score_3d_edges"</span><span data-if="python" style="display:none">"score_3d_edges"</span>, <span data-if="hdevelop" style="display:inline">'score_refined'</span><span data-if="c" style="display:none">"score_refined"</span><span data-if="cpp" style="display:none">"score_refined"</span><span data-if="com" style="display:none">"score_refined"</span><span data-if="dotnet" style="display:none">"score_refined"</span><span data-if="python" style="display:none">"score_refined"</span>, <span data-if="hdevelop" style="display:inline">'score_surface'</span><span data-if="c" style="display:none">"score_surface"</span><span data-if="cpp" style="display:none">"score_surface"</span><span data-if="com" style="display:none">"score_surface"</span><span data-if="dotnet" style="display:none">"score_surface"</span><span data-if="python" style="display:none">"score_surface"</span>, <span data-if="hdevelop" style="display:inline">'score_unrefined'</span><span data-if="c" style="display:none">"score_unrefined"</span><span data-if="cpp" style="display:none">"score_unrefined"</span><span data-if="com" style="display:none">"score_unrefined"</span><span data-if="dotnet" style="display:none">"score_unrefined"</span><span data-if="python" style="display:none">"score_unrefined"</span>, <span data-if="hdevelop" style="display:inline">'score_view_based'</span><span data-if="c" style="display:none">"score_view_based"</span><span data-if="cpp" style="display:none">"score_view_based"</span><span data-if="com" style="display:none">"score_view_based"</span><span data-if="dotnet" style="display:none">"score_view_based"</span><span data-if="python" style="display:none">"score_view_based"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="ResultIndex" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ResultIndex</span><span data-if="c" style="display:none">ResultIndex</span><span data-if="cpp" style="display:none">ResultIndex</span><span data-if="com" style="display:none">ResultIndex</span><span data-if="dotnet" style="display:none">resultIndex</span><span data-if="python" style="display:none">result_index</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Index of the matching result, starting with 0.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 1, 2, 3</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>ResultIndex &gt;= 0</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="ResultValue" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ResultValue</span><span data-if="c" style="display:none">ResultValue</span><span data-if="cpp" style="display:none">ResultValue</span><span data-if="com" style="display:none">ResultValue</span><span data-if="dotnet" style="display:none">resultValue</span><span data-if="python" style="display:none">result_value</span></code></b> (output_control)  </span><span>integer(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[HTupleElementType]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer / </span><span data-if="hdevelop" style="display:inline">string / </span><span data-if="hdevelop" style="display:inline">real / </span><span data-if="hdevelop" style="display:inline">handle)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">string / </span><span data-if="dotnet" style="display:none">double / </span><span data-if="dotnet" style="display:none">HHandle)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i> / </span><span data-if="cpp" style="display:none">HString / </span><span data-if="cpp" style="display:none">double / </span><span data-if="cpp" style="display:none">HHandle)</span><span data-if="c" style="display:none"> (<i>Hlong</i> / </span><span data-if="c" style="display:none">char* / </span><span data-if="c" style="display:none">double / </span><span data-if="c" style="display:none">handle)</span></span>
</div>
<p class="pardesc">Value of the result property.</p>
</div>
<h2 id="sec_result">结果</h2>
<p>If the handle of the result is valid, 该算子
<code><span data-if="hdevelop" style="display:inline">get_surface_matching_result</span><span data-if="c" style="display:none">get_surface_matching_result</span><span data-if="cpp" style="display:none">GetSurfaceMatchingResult</span><span data-if="com" style="display:none">GetSurfaceMatchingResult</span><span data-if="dotnet" style="display:none">GetSurfaceMatchingResult</span><span data-if="python" style="display:none">get_surface_matching_result</span></code> 返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .
If necessary an exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="find_surface_model.html"><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></a></code>, 
<code><a href="refine_surface_model_pose.html"><span data-if="hdevelop" style="display:inline">refine_surface_model_pose</span><span data-if="c" style="display:none">refine_surface_model_pose</span><span data-if="cpp" style="display:none">RefineSurfaceModelPose</span><span data-if="com" style="display:none">RefineSurfaceModelPose</span><span data-if="dotnet" style="display:none">RefineSurfaceModelPose</span><span data-if="python" style="display:none">refine_surface_model_pose</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="clear_surface_model.html"><span data-if="hdevelop" style="display:inline">clear_surface_model</span><span data-if="c" style="display:none">clear_surface_model</span><span data-if="cpp" style="display:none">ClearSurfaceModel</span><span data-if="com" style="display:none">ClearSurfaceModel</span><span data-if="dotnet" style="display:none">ClearSurfaceModel</span><span data-if="python" style="display:none">clear_surface_model</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="find_surface_model.html"><span data-if="hdevelop" style="display:inline">find_surface_model</span><span data-if="c" style="display:none">find_surface_model</span><span data-if="cpp" style="display:none">FindSurfaceModel</span><span data-if="com" style="display:none">FindSurfaceModel</span><span data-if="dotnet" style="display:none">FindSurfaceModel</span><span data-if="python" style="display:none">find_surface_model</span></a></code>, 
<code><a href="refine_surface_model_pose.html"><span data-if="hdevelop" style="display:inline">refine_surface_model_pose</span><span data-if="c" style="display:none">refine_surface_model_pose</span><span data-if="cpp" style="display:none">RefineSurfaceModelPose</span><span data-if="com" style="display:none">RefineSurfaceModelPose</span><span data-if="dotnet" style="display:none">RefineSurfaceModelPose</span><span data-if="python" style="display:none">refine_surface_model_pose</span></a></code>, 
<code><a href="read_surface_model.html"><span data-if="hdevelop" style="display:inline">read_surface_model</span><span data-if="c" style="display:none">read_surface_model</span><span data-if="cpp" style="display:none">ReadSurfaceModel</span><span data-if="com" style="display:none">ReadSurfaceModel</span><span data-if="dotnet" style="display:none">ReadSurfaceModel</span><span data-if="python" style="display:none">read_surface_model</span></a></code>, 
<code><a href="write_surface_model.html"><span data-if="hdevelop" style="display:inline">write_surface_model</span><span data-if="c" style="display:none">write_surface_model</span><span data-if="cpp" style="display:none">WriteSurfaceModel</span><span data-if="com" style="display:none">WriteSurfaceModel</span><span data-if="dotnet" style="display:none">WriteSurfaceModel</span><span data-if="python" style="display:none">write_surface_model</span></a></code>, 
<code><a href="clear_surface_model.html"><span data-if="hdevelop" style="display:inline">clear_surface_model</span><span data-if="c" style="display:none">clear_surface_model</span><span data-if="cpp" style="display:none">ClearSurfaceModel</span><span data-if="com" style="display:none">ClearSurfaceModel</span><span data-if="dotnet" style="display:none">ClearSurfaceModel</span><span data-if="python" style="display:none">clear_surface_model</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
3D Metrology</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
